home *** CD-ROM | disk | FTP | other *** search
/ MPEG Toolkit / MPEG Toolkit.iso / win / ladybug / readme.txt < prev    next >
Encoding:
Text File  |  1997-01-01  |  11.3 KB  |  265 lines
  1. ========================================================================
  2. Ladybug 1.00 for Windows
  3. ========================================================================
  4.  
  5. Agreement of Using Ladybug 1.00 for Windows Demo.
  6.  
  7. This is the agreement about Ladybug 1.00 for Windows Demo 
  8. between you (user) and Neat Software Company.
  9.  
  10. This is the demo program of Ladybug 1.00 for Windows. 
  11. There are limited MPEG files to playback. You can test it for 
  12. preview purpose. You can free copy and redistribute this Demo 
  13. program but you can not sale it for any commericial purpose .
  14. You can only redistribute this software in original ladybug.zip
  15. form. This software remains a confidential trade secret of 
  16. Neat Software. Any attempts to modify, decompile, disassemble 
  17. or reverse engineer this software are not allowed. 
  18.  
  19. If you do not agree this agreement please do not use this Demo software.
  20.  
  21. ========================================================================
  22. 1. Introduction
  23. ========================================================================
  24. MPEG means "Moving Picture Experts Group". This group is working under 
  25. the direction of the International Standards Organization (ISO) for the 
  26. standards of compressed motion pictures and associated audio. MPEG-1 
  27. had been completed in Oct. 92 known as International Standard ISO-11172.
  28.  
  29. Ladybug 1.00 is a software implementation of MPEG-1 decoder without 
  30. audio associated. It works from reading a .mpg file and then decoding the 
  31. code with Huffman decode algorithm, IDCT (Inverse Discrete Cosine Transform), 
  32. Motion Compensition for P (Predicated) and B (Bidirectional) frames, 
  33. and Halftone algorithms.
  34.  
  35. Ladybug 1.00 Properties:
  36.  
  37. Object-Oriented Software System
  38. Friendly Graphic Uesr Interface (GUI)
  39. View MPEG File In Variable Window Size
  40. Used as a MPEG Viewer on Internet with a WWW browser
  41. Decode full MPEG-1 video frame types (all I, P, B frames) 
  42. Graphics Accelerator with WinG in Windows 3.1
  43. 32bit Optimization Code For x86 Processor
  44.  
  45. ========================================================================
  46. 2. Architecture
  47. ========================================================================
  48. Ladybug is designed as an envolution software system that is
  49. portable to many platforms. There are several releases of
  50. Ladybug target at different markets. Network version is
  51. optimized for Internet access. It can connected with a WWW
  52. borwser such as Mosic and Netscape to view the MPEG video
  53. clips through Internet. CDROM version is optimized for CD-ROM
  54. access. It includes some interactive and index fundtions.
  55. It is a basic tool to play titles and games on the CD-ROM.
  56.  
  57. This release is the Network version of the Ladybug 1.00 for Windows.
  58.  
  59. Ladybug Architecture
  60.  
  61. USER            CD-ROM titles, Games, Network Browser, Education
  62. SYSTEM        Windows95/NT, Windows 3.1 + Win32s + WinG
  63. ARCHITECTURE    Object-Oriented System, Graphic User Interface
  64.                 Graphic Acceleration
  65. MICRO-STRUCTURE    Video --> GOP --> Picture --> Slice --> Microblock 
  66.                 --> Block->Huffman --> IDCT-->Bit Stream
  67.  
  68. ========================================================================
  69. 3. Object Oriented User Interface
  70. ========================================================================
  71. Ladybug is an object-oriented MPEG player. Users view the mpeg
  72. object through a window objcet and select the demanded commands
  73. or operations by menu, button, and dialog box. The mouse and
  74. keyboard are the main pointer devices. After running the ladybug,
  75. a window object is displayed on the screen. It includes
  76.  
  77. <System menu> can be used to close the object and resize the window.
  78. <Title bar> shows the name of the .mpg file object. When there
  79.         are no open files, the window display "Ladybug for MPEG".
  80.         Users can point at the title bar and drag the window to
  81.         relocate.
  82. <Client area> shows the animation of a MPEG object. It is also an
  83.         interactive area that users can active a pop-up menu to
  84.         operate on the object.
  85. <Menus> are a common way of presenting commands in an interface.
  86.         There are a list of <items> in a menu that represent the
  87.         commands. In the Ladybug pop-up menu is the efficient
  88.         interactive tools to view and command an object. In this
  89.         way Ladybug demonstrates the principle of display on demand.
  90.         Pop-up menu is displayed at the current location of the mouse
  91.         cursor, this eleminates the need to navigate the mouse to
  92.         get commands. It also saves the screen space.
  93.  
  94. When clicking the client area of the Ladybug window with the right
  95. mouse button, a pop-up menu is displayed. On the down transition
  96. of the right button, the MPEG object is identified. On the up the
  97. menu is displayed to the center and below the cursor location of
  98. the mouse. The menu items in the pop-up menu of the Ladybug are
  99. always connected to the MPEG object.
  100.  
  101. ========================================================================
  102. 4. Requirements
  103. ========================================================================
  104. Hardware Environment Requirements
  105. Machine                Minimum 386sx, 
  106.             Better for 486DX, DX2, DX4, 
  107.             Best for Pentium, K86
  108. Memory                 4 MByte memory above                  
  109. Harddisk               5 MByte free space available                        
  110. Video Card              SVGA or higher with 256 or 16.7 millions colors
  111.             The best picture quality is for 800x600
  112.                         or 1024x768 256 colors
  113.                                                       
  114. Software Environment Requirements
  115. Windows 3.1/Win3.11    win32s 1.20 and WinG 1.0 is required.
  116. Windows NT/Windows95  win32s is not needed. 
  117.  
  118. ========================================================================
  119. 5. Installation
  120. ========================================================================
  121. It is very easy to install on Windows95.
  122. 1.  Get Ladybug file
  123.         In DOS prompt:          C:>
  124.     Make a sub-directory:    C:>md c:\ladybug
  125.         Copy ladybug.zip:       C:>copy a:\ladybug.zip  c:\ladybug
  126.                 or Download from Network to c:\ladybug
  127.     Uncompress:        C:>pkunzip ladybug.zip                         
  128. 2. Install
  129.         In DOS prompt           C:>install                                                  
  130. 3. Test
  131.         In Windos95:            Double Click ladybug.exe to begin
  132.  
  133. Notes:
  134. The Ladybug 1.00 for Windows95 Demo can only play MPEG files
  135. less than 500KB and some special files. The special files can
  136. be retrived with Netscape or Mosic by open the local file demo.htm.
  137. These files are very nice MPEG movies on the Internet. Your Netscape
  138. or Mosaic browser should set the FTP function.  
  139.  
  140. Tips:
  141. Set your Display in 800*600 or 1024*768, 256 colors model. 
  142. Run Ladybug for Windows95 on Pentium will show best performance
  143. Try resize the window in every size
  144. Try to use Ladybug 1.00 for Windows95 with Netscape or Mosaic.
  145. Try to run 3 or 4 Ladybug to demostrate the multitask in Windows95
  146.  
  147. ========================================================================
  148. 6. Playback
  149. ========================================================================
  150. Playback with Disk or CD-ROM File
  151.  
  152. Click the Ladybug 1.00 Shortcut or Run ladybug.exe a initial
  153. window is displayed. Click RIGHT MOUSE BUTTON in the area of
  154. the initial window, there is a floating popup menu appeared.
  155. There are several menu items on the popup menu.
  156.  
  157.  
  158. Command        Action
  159.  
  160. Open            to open a .mpg file select a .mpg file from a file list box 
  161. SaveAs          to save a frame of video as a image file.
  162. Play            to play a opened .mpg file if you press the right                
  163.                 button of the mouse the player will pause and display            
  164.                 the popup menu. If you select the Stop item, when 
  165.                 you press the left button of the mouse, the player will                  
  166.                 stop, otherwise the player will continue.
  167. Step            to play forward step by step.
  168. Stop            to stop the palyer.
  169. Options         to make the choice of a checklist you could choice 2                     
  170.                 times image and so on.
  171. Infomation?     to display ladybug information when you finish a                         
  172.                 .mpg play. You could read the timing result and the rate 
  173.                 of frames per second. Clicking the Help button you can           
  174.                 read online help file.
  175. Exit            to exit the Ladybug
  176.  
  177.  
  178. While you are playing if you press right mouse button down, the
  179. popup menu appeared and the player pause. When you press left
  180. mouse button again without choice any items, the playing procedure
  181. continue. If you select stop item, the Ladybug shows the demo window
  182. and stop.
  183.  
  184. Playback With A WWW Browser
  185.  
  186. MIME (Multipurpose Internet Mail Extensions) is a method to organize
  187. file types. Mosaic and Netscape can not handle all the MIME file
  188. types internally. So you need external viewers to associate some
  189. MIME files and read them.
  190.  
  191. Name                MIME TYPE
  192.  
  193. HTML                .html
  194. Compressed File            .zip
  195. Rich Text Format                .rtf
  196. PostScript             .ps
  197. MPEG                .mpg or .mpeg
  198. JPEG                .jpg
  199. Word Doc            .doc
  200. Audio                .au or aiff
  201.  
  202. In the Mosaic:
  203.  
  204. You need a external viewer and associate these file types to
  205. an application in the MOSAIC.INI file. When active a file
  206. Mosaic will invoke the viewer.
  207.  
  208. Edit the MOSAIC.INI
  209. In the [Viewers] section of the MOSAIC.INI file add
  210.  
  211.     TYPE1023="video/mpeg"
  212.     
  213. where we set n=1023 make sure it is a unique integer.
  214.  
  215.     video/mpeg="c:\ladybug\ladybug.exe %ls"
  216.  
  217. c:\ladybug is the directory where the ladybug.exe is in.
  218.  
  219. In the [Suffixes] section define the file type extensions. 
  220.  
  221.     video/mpeg=.mpeg, .mpg
  222.  
  223. Save the MOSAIC.INI file and restart the mosaic.
  224.  
  225. In the Netscape:
  226.  
  227. Start Netscape, choose Options|Preferences item. Push the
  228. first button with panel (default is Styles), select the item
  229. Helper Applications. To have Netscape start an external viewer,
  230. select the Mime Type in the list, then choose the radio button
  231. Launch Application. Choose ladybug.exe as the .mpg external viewer.
  232.  
  233. ========================================================================
  234. 7. Copyright
  235. ========================================================================
  236. Neat Software Company owns the copyright of Ladybug 1.00 for
  237. Windows. It is co in the United States in 
  238.  
  239. Ladybug 1.00 for Windows/Windows95  is a motion video (MPEG)
  240. player running on Windows 3.1./NT/Windows95. It is a commercial
  241. version of the Ladybug, including technical support from Neat
  242. Software Company. Ladybug 1.00 is protected by the copyright
  243. law in the United States from 1994. The software in source code
  244. form remains a confidential trade secret of Neat Software.
  245. Any attempts to decompile, disassemble or reverse engineer this
  246. software are not allowed. 
  247.  
  248. Windows 3.1, Win32s, WinG, Windows95, Wnidows NT are trade 
  249. marks of Microsoft Corp. Pentium is the trade mark of Intel Corp.
  250. Mosaic is the trade mark of NCSA. Netscape is the trade mark of the 
  251. Netscape communication.
  252.  
  253. ========================================================================
  254. 8. Contact
  255. ========================================================================
  256. Neat Software Co.            Tel: (204)269-3593            
  257. 616 Townsend Ave.            Fax:(204)269-3593
  258. Winnipeg, Manitoba R3T 2V2    
  259. Canada
  260. Attn: Chang LI        
  261.  
  262. Email: changl@cs.umanitoba.ca
  263. WWW: http://www.cs.umanitoba.ca/~changl/neat/neat.html
  264.  
  265. Have fun with Ladybug 1.00 for Windows95.